home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat7 / cl.z / cl
Encoding:
Text File  |  2002-10-03  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCLLLL((((7777MMMM))))                                                                  CCCCLLLL((((7777MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_llll - CrayLink Driver
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _////_hhhh_wwww_////_xxxx_pppp_llll_iiii_nnnn_kkkk_////_rrrr_aaaa_wwww_////_****_////_****
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _cccc_llll module provides a raw device interface to XPC (cross partition
  18.      communication).  These devices take advantage of the XPC rendezvous
  19.      capabilities to allow DMA transfers directly from the source to the
  20.      destination without any intermediate copying if possible.  The DMA
  21.      operation is done using the BTE which supports transfers of multiple
  22.      cache lines on cache line boundaries.  Therefore, in order to avoid the
  23.      overhead of the _cccc_llll driver copying data to an intermediate buffer, the
  24.      source and destination must be 128 byte aligned.  If the transfer is not
  25.      a multiple of 128 bytes, only the last part of the cache line will be
  26.      copied through an intermediate buffer.
  27.  
  28.  
  29.      The cross partition raw devices are located in the directory
  30.      ////hhhhwwww////xxxxpppplllliiiinnnnkkkk////rrrraaaawwww////<<<<rrrreeeemmmmooootttteeee____ppppaaaarrrrttttiiiittttiiiioooonnnn>>>>////<<<<ddddeeeevvvviiiicccceeee____nnnnuuuummmmbbbbeeeerrrr>>>>, where
  31.      <<<<rrrreeeemmmmooootttteeee____ppppaaaarrrrttttiiiittttiiiioooonnnn>>>> is the partition ID to which a device should be
  32.      opened, and the <<<<ddddeeeevvvviiiicccceeee____nnnnuuuummmmbbbbeeeerrrr>>>> specifies which of the 16 possible
  33.      devices to open.  These devices appear in the _hhhh_wwww_gggg_rrrr_aaaa_pppp_hhhh(4) the first time a
  34.      remote partition is discovered (or activated) as two digit hexadecimal
  35.      numbers.  They are never removed.
  36.  
  37.  
  38.      Once a _cccc_llll device is opened using the _oooo_pppp_eeee_nnnn(2) system call (and closed
  39.      using _cccc_llll_oooo_ssss_eeee(2)), the file descriptors may be used to exchanged data with
  40.      the remote partition using the _rrrr_eeee_aaaa_dddd(2), _wwww_rrrr_iiii_tttt_eeee(2), and _ssss_eeee_llll_eeee_cccc_tttt(2) system
  41.      calls.  The devices provide a byte stream type interface.
  42.  
  43.  
  44.      _oooo_pppp_eeee_nnnn(2), _cccc_llll_oooo_ssss_eeee(2), _rrrr_eeee_aaaa_dddd(2), _wwww_rrrr_iiii_tttt_eeee(2), or _ssss_eeee_llll_eeee_cccc_tttt(2) will fail for the _cccc_llll
  45.      devices and return to the calling process if one or more of the following
  46.      are true
  47.  
  48.  
  49.      EEEEIIIIOOOO         XPC could not be established for the partition requested.
  50.  
  51.  
  52.      EEEENNNNOOOODDDDEEEEVVVV      The partition to which communication is requested no longer
  53.                  exists.
  54.  
  55.  
  56.      EEEENNNNOOOODDDDEEEEVVVV      The _cccc_llll raw device requested does not exist on the remote
  57.                  partition.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCLLLL((((7777MMMM))))                                                                  CCCCLLLL((((7777MMMM))))
  71.  
  72.  
  73.  
  74.      EEEEIIIINNNNTTTTRRRR       A synchronous read or write was interrupted before
  75.                  completion.
  76.  
  77.  
  78.      EEEENNNNOOOOTTTTCCCCOOOONNNNNNNN    The XPC channel for this raw device has been unexpectedly
  79.                  disconnected.
  80.  
  81.  
  82.      EEEEWWWWOOOOUUUULLLLDDDDBBBBLLLLOOOOCCCCKKKK The call would have blocked if the O_NONBLOCK flag had not
  83.                  been specified to the _oooo_pppp_eeee_nnnn(2) function.
  84.  
  85.  
  86.      EEEEBBBBUUUUSSSSYYYY       The raw device is currently busy connecting or disconnecting
  87.                  with the remote partition.
  88.  
  89.  
  90.      EEEEAAAAGGGGAAAAIIIINNNN      The XPC layer is still setting up.
  91.  
  92.  
  93.      EEEENNNNOOOOTTTTSSSSUUUUPPPP     The partition we are trying to communicate with does not have
  94.                  support for XPC.
  95.  
  96.  
  97. FFFFIIIILLLLEEEESSSS
  98.      _////_hhhh_wwww_////_xxxx_pppp_llll_iiii_nnnn_kkkk_////_rrrr_aaaa_wwww_////_****_////_****
  99.      _////_vvvv_aaaa_rrrr_////_ssss_yyyy_ssss_gggg_eeee_nnnn_////_mmmm_aaaa_ssss_tttt_eeee_rrrr_...._dddd_////_cccc_llll
  100.  
  101.  
  102. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  103.      _oooo_pppp_eeee_nnnn(2), _cccc_llll_oooo_ssss_eeee(2), _ssss_eeee_llll_eeee_cccc_tttt(2), _rrrr_eeee_aaaa_dddd(2), _wwww_rrrr_iiii_tttt_eeee(2), _mmmm_kkkk_pppp_aaaa_rrrr_tttt(1m), _hhhh_wwww_gggg_rrrr_aaaa_pppp_hhhh(4)
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.